We don’t talk about Quarto

We don’t talk about Quarto

Others had more questions…

What is a “Quarto”?

What is a “Quarto”?¹

Ok, but what IS Quarto®?

Ok, but what IS Quarto®?

Quarto® is an open-source scientific and technical publishing system built on Pandoc

Image: Kobby Mendez

Crafting a cocktail

“Crafting” process for literate programming

“Crafting” process for literate programming

“Crafting” process for literate programming

So what is Quarto?

A Quarto document i.e. a .qmd is a plain text file, like a .rmd, that can be rendered to many different formats

Anatomy of a Quarto document

• Metadata (YAML)

---
format: html
---

```{r}
#| eval: true
library(dplyr)
mtcars |> 
  group_by(cyl) |> 
  summarize(mean = mean(mpg), .groups = "drop")
```

# A tibble: 3 × 2
    cyl  mean
  <dbl> <dbl>
1     4  26.7
2     6  19.7
3     8  15.1

# Heading 1
This is a sentence with some **bold text**, some *italic text* and an [image](image.png).

So what is Quarto?

Quarto is a command line interface (CLI) that renders plain text formats (.qmd, .rmd, .md) OR mixed formats (.ipynb/Jupyter notebook) into PDF/Word/HTML reports, books, websites, presentations and more!

So what is Quarto?

A brief history of knitr¹

• 2011-10-16: initial development - an engine for dynamic report generation with R

• 2012-01-17: initial CRAN release

• 50 CRAN releases in 10 years https://cran.r-project.org/src/contrib/Archive/knitr/

A brief history of rmarkdown

• Initial experiment: knitr::pandoc() (2014)²

• Matured as the rmarkdown package (2015)

Quarto - unification for RMarkdown

We learned from 10 years of literate programming with knitr + rmarkdown - Quarto is the continuation and unification of the best parts of RMarkdown via knitr.

RMarkdown and knitr are not going away, we’re still supporting it!

Quarto - extending RMarkdown for other languages

We are meeting Julia/Python users in their native language

Photo by zero take

roam in color

Comfort of your own workspace

One install, “Batteries included”

• Any language, same syntax and approach

Many Quarto formats

Built-in tabsets

```{r penguin-sum}
#| eval: false
penguin_sum <- palmerpenguins::penguins |>
  group_by(species, sex) |>
  summarize(
    n = n(),
    across(
      c(body_mass_g, bill_length_mm, flipper_length_mm),
      list(
        mean = ~ mean(.x, na.rm = TRUE), 
        sd = ~ sd(.x, na.rm = TRUE)
      )
    ),
  )

penguin_sum
```

# A tibble: 8 × 9
# Groups:   species [3]
  species   sex        n body_mass_g_mean body_mass_g_sd bill_length_mm_mean
  <fct>     <fct>  <int>            <dbl>          <dbl>               <dbl>
1 Adelie    female    73            3369.           269.                37.3
2 Adelie    male      73            4043.           347.                40.4
3 Adelie    <NA>       6            3540            477.                37.8
4 Chinstrap female    34            3527.           285.                46.6
5 Chinstrap male      34            3939.           362.                51.1
6 Gentoo    female    58            4680.           282.                45.6
7 Gentoo    male      61            5485.           313.                49.5
8 Gentoo    <NA>       5            4588.           338.                45.6
# … with 3 more variables: bill_length_mm_sd <dbl>,
#   flipper_length_mm_mean <dbl>, flipper_length_mm_sd <dbl>

Figure Layout

::: {layout-nrow=2}
![Surus](surus.png)

![Hanno](hanno.png)

![Abdul Abbas](abdul-abbas.png)

![Lin Wang](lin-wang.png)
:::

What to do with my existing .Rmd or .ipynb?

RMarkdown (and knitr) is not going away!

quarto render my-favorite.rmd --to html

quarto render my-favorite.ipynb --to html --execute

What to do with my existing .Rmd or .ipynb?

In fact, Quarto can help convert back and forth between .qmd and .ipynb:

quarto convert --help

Usage:   quarto convert <input>

Description:

    Convert documents to alternate representations.

  Convert notebook to markdown:                  quarto convert mydocument.ipynb                   
  Convert markdown to notebook:                  quarto convert mydocument.qmd                     
  Convert notebook to markdown, writing to file: quarto convert mydocument.ipynb --output mydoc.qmd

What about for Data Science at Work?

• Quarto can be used in RStudio Team today!

Cocktails vs Mixed Drinks

Quarto, crafted with love and care

Development of Quarto is sponsored by RStudio, PBC. The same core team works on both Quarto and R Markdown:

• Carlos Scheidegger (@cscheid)

• Charles Teague (@dragonstyle)

• Christophe Dervieux (@cderv)

• J.J. Allaire (@jjallaire)

• Yihui Xie (@yihui)

Here is the full contributors list. Quarto is open source and we welcome contributions in our github repository as well! https://github.com/quarto-dev/quarto-cli.

Want more?

Follow @RStudio, @quarto_pub or me @thomas_mock on Twitter to stay up to date!